home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 19 / CU Amiga Magazine's Super CD-ROM 19 (1998)(EMAP Images)(GB)[!][issue 1998-02].iso / CUCD / Online / RFCs / rfc / rfc2238.txt < prev    next >
Text File  |  1997-12-07  |  65KB  |  1,964 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                B. Clouston, Editor
  8. Request for Comments: 2238                                 Cisco Systems
  9. Category: Standards Track                               B. Moore, Editor
  10.                                                          IBM Corporation
  11.                                                            November 1997
  12.  
  13.  
  14.                      Definitions of Managed Objects
  15.                           for HPR using SMIv2
  16.  
  17.  
  18. Status of this Memo
  19.  
  20.    This document specifies an Internet standards track protocol for the
  21.    Internet community, and requests discussion and suggestions for
  22.    improvements.  Please refer to the current edition of the "Internet
  23.    Official Protocol Standards" (STD 1) for the standardization state
  24.    and status of this protocol.  Distribution of this memo is unlimited.
  25.  
  26. Copyright Notice
  27.  
  28.    Copyright (C) The Internet Society (1997).  All Rights Reserved.
  29.  
  30. Table of Contents
  31.  
  32.    1.     Status of this Memo  .....................................  1
  33.    2.     Introduction  ............................................  1
  34.    3.     The SNMP Network Management Framework  ...................  2
  35.    4.     Overview  ................................................  2
  36.    4.1      HPR MIB structure ......................................  3
  37.    5.     Definitions  .............................................  5
  38.    6.     Acknowledgments  ........................................  33
  39.    7.     References  .............................................  33
  40.    8.     Security Considerations  ................................  33
  41.    9.     Authors' Addresses  .....................................  34
  42.    10.    Full Copyright Statement ................................  35
  43.  
  44. 2.  Introduction
  45.  
  46.    This memo defines a portion of the Management Information Base (MIB)
  47.    for use with network management protocols in the Internet community.
  48.    In particular, it defines objects for monitoring and controlling
  49.    network devices with HPR (High Performance Routing) capabilities.
  50.    This memo identifies managed objects for the HPR protocol.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Clouston & Moore            Standards Track                     [Page 1]
  59.  
  60. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  61.  
  62.  
  63. 3.  The SNMP Network Management Framework
  64.  
  65.    The SNMP Network Management Framework consists of several components.
  66.    For the purpose of this specification, the applicable components of
  67.    the Framework are the SMI and related documents [1, 2, 3], which
  68.    define the mechanisms used for describing and naming objects for the
  69.    purpose of management.
  70.  
  71.    The Framework permits new objects to be defined for the purpose of
  72.    experimentation and evaluation.
  73.  
  74. 4.  Overview
  75.  
  76.    This document identifies objects for monitoring the configuration and
  77.    active characteristics of devices with HPR capabilities.  HPR is an
  78.    enhancement to the Advanced Peer-to-Peer Network (APPN) architecture
  79.    that provides fast data routing and improved session reliability.
  80.    APPN is one of the protocols that can use the HPR transport
  81.    mechanism.  See the SNANAU APPN MIB [4] for management of APPN and
  82.    APPN use of the HPR transport.
  83.  
  84.    The HPR terms and overall architecture [5] are available at
  85.    http://www.networking.ibm.com/app/aiwdoc/aiwsrc.htm.
  86.  
  87.    Automatic Network Routing (ANR) is a fast low-level routing
  88.    technique.  Each node assigns a unique (within that node) ANR label
  89.    for each out-bound link as it is activated.  The label size is
  90.    defined by the ANR node, and nodes only need to know how to interpret
  91.    their own labels.  The ANR string is a group of ANR labels encoded in
  92.    a header in front of the message being sent.  At each hop the node
  93.    strips off its own ANR label and forwards the message onto the link
  94.    with that label.  The last label in the string is the Network
  95.    Connection Endpoint (NCE), which identifies the component within the
  96.    destination node that is to receive the message.
  97.  
  98.    Rapid Transport Protocol (RTP) is an end-to-end full duplex transport
  99.    connection (pipe).  It provides for high-speed transport of data
  100.    using ANR.  RTP is connection-oriented, and delivers data in correct
  101.    order reliably.  Error recovery is done efficiently with selective
  102.    retransmission of data.  An RTP path can be switched without
  103.    disrupting the sessions using it.  An RTP path switch may be done
  104.    automatically if a link in the path fails and another RTP path is
  105.    available, or on demand to attempt to restore the optimal path.
  106.  
  107.    RTP performs flow/congestion control with the Adaptive Rate-Based
  108.    (ARB) algorithm, described in [5]. ARB is done only at the endpoints
  109.    of the RTP pipe, so intermediate hops are not involved.
  110.  
  111.  
  112.  
  113.  
  114. Clouston & Moore            Standards Track                     [Page 2]
  115.  
  116. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  117.  
  118.  
  119.    ARB regulates the flow of data over an RTP connection by adaptively
  120.    changing the sender's rate based on feedback on the receiver's rate.
  121.    It is designed to prevent congestion rather than react to it.
  122.  
  123.    In this document, we describe HPR managed objects.
  124.  
  125.    Highlights of the management functions supported by the HPR MIB
  126.    module include the following:
  127.  
  128.    o    Identifying network connection endpoints (NCEs).
  129.  
  130.    o    Identifying how incoming packets are routed based on ANR labels.
  131.  
  132.    o    Monitoring the RTP connections between nodes.
  133.  
  134.    o    Ability to trigger an RTP path switch.  The MIB only supports a
  135.         path switch with no specified path.  Some implementations may
  136.         have a product-specific option to specify a new path.  The
  137.         hprOperatorPathSwitchSupport object identifies this support.
  138.  
  139.    o    Historical information about RTP path switch attempts.
  140.  
  141.    This MIB module does not support:
  142.  
  143.    o    Configuration of HPR nodes.
  144.  
  145.    o    Protocol-specific uses of HPR (such as APPN).
  146.  
  147.    o    Traps.  The APPN MIB contains a trap for Alert conditions that
  148.         may affect HPR resources.  The value for the affectedObject
  149.         object contained in the alertTrap is determined by the
  150.         implementation.  It may contain a VariablePointer from the HPR
  151.         MIB.  The APPN/HPR Alerts are defined in [6].
  152.  
  153. 4.1.  HPR MIB Structure
  154.  
  155.    Although HPR is an extension to APPN, the HPR MIB relies very little
  156.    upon the APPN MIB.  The appnNodeCounterDisconTime object in the APPN
  157.    MIB is used to detect discontinuities in HPR MIB counters.  The
  158.    hprNodeCpName object in this MIB has the same value as the
  159.    appnNodeCpName object in the APPN MIB.
  160.  
  161.    The HPR MIB module contains the following collections of objects:
  162.  
  163.    o    hprGlobal - general HPR objects.
  164.  
  165.    o    hprAnrRouting - objects related to the ANR routing table.
  166.  
  167.  
  168.  
  169.  
  170. Clouston & Moore            Standards Track                     [Page 3]
  171.  
  172. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  173.  
  174.  
  175.    o    hprTransportUser - objects related to users of the HPR
  176.         transport.
  177.  
  178.    o    hprRtp - objects related to the HPR Transport Tower.
  179.  
  180.    These are described below in more detail.
  181.  
  182. 4.1.1.  hprGlobal group
  183.  
  184.    The hprGlobal group consists of general objects such as the APPN CP
  185.    (control point) name of the HPR node and the level of support for
  186.    operator-requested path switches.
  187.  
  188. 4.1.2.  hprAnrRouting group
  189.  
  190.    The hprAnrRouting group consists objects to monitor and control the
  191.    counting of ANR packets received and the following table:
  192.  
  193.    The hprAnrRoutingTable correlates incoming ANR labels to the outbound
  194.    transmission group (TG) or local NCE to which incoming packet will be
  195.    forwarded.  An entry defines the label type as identifying a local
  196.    NCE or a TG, identifies the NCE or TG, and counts the number of
  197.    packets received with the entry's ANR label.
  198.  
  199. 4.1.3.  hprTransportUser group
  200.  
  201.    The hprTransportUser group consists of the following table:
  202.  
  203.    The hprNceTable identifies network connection endpoints and their
  204.    function types.  The function type can be any combination of a CP,
  205.    logical unit (LU), boundary function, and route setup.
  206.  
  207. 4.1.4.  hprRtp group
  208.  
  209.    The hprRtp group consists of the following objects and tables:
  210.  
  211.    1) hprRtpGlobe
  212.  
  213.    These objects contain information about the number of RTP connection
  214.    setups, and control of RTP counters.
  215.  
  216.    2) hprRtpTable
  217.  
  218.    This table contains one entry for each RTP connection.  The
  219.    information includes local and remote NCE IDs and TCIDs (transport
  220.    connection identifiers), timers, send rates, and statistics.  A path
  221.    switch can be triggered by the hprRptPathSwitchTrigger object if the
  222.    agent node supports it; however, a new path cannot be specified.
  223.  
  224.  
  225.  
  226. Clouston & Moore            Standards Track                     [Page 4]
  227.  
  228. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  229.  
  230.  
  231.    3) hprRtpStatusTable
  232.  
  233.    This table contains statistics and historical information for RTP
  234.    path switches attempts, including old and new ANR strings and Route
  235.    Selection Control Vectors (RSCVs), why the path switch was initiated,
  236.    and the result (successful or reason for failure).
  237.  
  238. 5.  Definitions
  239.  
  240. HPR-MIB DEFINITIONS ::= BEGIN
  241.  
  242.   IMPORTS
  243.         DisplayString, DateAndTime, TimeStamp, TEXTUAL-CONVENTION
  244.                 FROM SNMPv2-TC
  245.  
  246.         Counter32, Gauge32, Unsigned32, TimeTicks,
  247.         OBJECT-TYPE, MODULE-IDENTITY
  248.                 FROM SNMPv2-SMI
  249.  
  250.         MODULE-COMPLIANCE, OBJECT-GROUP
  251.                 FROM SNMPv2-CONF
  252.  
  253.         snanauMIB
  254.                 FROM SNA-NAU-MIB
  255.  
  256.         SnaControlPointName
  257.                 FROM APPN-MIB;
  258.  
  259. hprMIB MODULE-IDENTITY
  260.         LAST-UPDATED  "970514000000Z"
  261.         ORGANIZATION  "AIW APPN / HPR MIB SIG"
  262.         CONTACT-INFO
  263.  
  264.                 "
  265.  
  266.                         Bob Clouston
  267.                         Cisco Systems
  268.                         7025 Kit Creek Road
  269.                         P.O. Box 14987
  270.                         Research Triangle Park, NC 27709, USA
  271.                         Tel:    1 919 472 2333
  272.                         E-mail: clouston@cisco.com
  273.  
  274.                         Bob Moore
  275.                         IBM Corporation
  276.                         800 Park Offices Drive
  277.                         RHJA/664
  278.                         P.O. Box 12195
  279.  
  280.  
  281.  
  282. Clouston & Moore            Standards Track                     [Page 5]
  283.  
  284. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  285.  
  286.  
  287.                         Research Triangle Park, NC 27709, USA
  288.                         Tel:    1 919 254 4436
  289.                         E-mail: remoore@ralvm6.vnet.ibm.com
  290.                 "
  291.       DESCRIPTION
  292.                 "This is the MIB module for objects used to
  293.                  manage network devices with HPR capabilities."
  294. ::= { snanauMIB 6 }
  295. -- snanauMIB ::= { mib-2 34 }
  296.  
  297. -- *********************************************************************
  298. -- Textual Conventions
  299. -- *********************************************************************
  300. -- SnaControlPointName is imported from the APPN MIB
  301.  
  302. HprNceTypes ::= TEXTUAL-CONVENTION
  303.       STATUS current
  304.       DESCRIPTION
  305.           "A bit string identifying the set of functions provided by a
  306.           network connection endpoint (NCE).  The following values are
  307.           defined:
  308.  
  309.                 bit 0:  control point
  310.                 bit 1:  logical unit
  311.                 bit 2:  boundary function
  312.                 bit 3:  route setup
  313.           "
  314.  
  315.       SYNTAX BITS { controlPoint(0),
  316.                     logicalUnit(1),
  317.                     boundaryFunction(2),
  318.                     routeSetup(3) }
  319.  
  320. HprRtpCounter ::= TEXTUAL-CONVENTION
  321.       STATUS current
  322.       DESCRIPTION
  323.           "An object providing statistics for an RTP connection.  A
  324.           Management Station can detect discontinuities in this counter
  325.           by monitoring the correspondingly indexed
  326.           hprRtpCounterDisconTime object."
  327.  
  328.       SYNTAX Counter32
  329.  
  330. -- *********************************************************************
  331.   hprObjects         OBJECT IDENTIFIER ::= { hprMIB 1 }
  332. -- *********************************************************************
  333.  
  334. -- *********************************************************************
  335.  
  336.  
  337.  
  338. Clouston & Moore            Standards Track                     [Page 6]
  339.  
  340. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  341.  
  342.  
  343. hprGlobal            OBJECT IDENTIFIER ::= { hprObjects 1 }
  344. -- *********************************************************************
  345. -- The hprGlobal group applies to both intermediate and end nodes.
  346. -- *********************************************************************
  347.  
  348. hprNodeCpName OBJECT-TYPE
  349.       SYNTAX SnaControlPointName
  350.       MAX-ACCESS read-only
  351.       STATUS current
  352.       DESCRIPTION
  353.           "Administratively assigned network name for the APPN node
  354.           where this HPR implementation resides.  If this object has
  355.           the same value as the appnNodeCpName object in the APPN MIB,
  356.           then the two objects are referring to the same APPN node."
  357.  
  358.       ::= { hprGlobal 1 }
  359.  
  360. hprOperatorPathSwitchSupport  OBJECT-TYPE
  361.       SYNTAX INTEGER {
  362.                       notSupported(1),
  363.                       switchTriggerSupported(2),
  364.                       switchToPathSupported(3)
  365.                      }
  366.       MAX-ACCESS read-only
  367.       STATUS current
  368.       DESCRIPTION
  369.           "This object indicates an implementation's level of support
  370.           for an operator-requested path switch.
  371.  
  372.             notSupported(1)           - the agent does not support
  373.                                         operator-requested path switches
  374.             switchTriggerSupported(2) - the agent supports a 'switch
  375.                                         path now' command from an
  376.                                         operator, but not a command to
  377.                                         switch to a specified path
  378.             switchToPathSupported(3)  - the agent supports both a
  379.                                         'switch path now' command and a
  380.                                         command to switch to a specified
  381.                                         path.  Note that the latter
  382.                                         command is not available via
  383.                                         this MIB; a system that supports
  384.                                         it must do so via other means,
  385.                                         such as a local operator
  386.                                         interface."
  387.  
  388.       ::= { hprGlobal 2 }
  389.  
  390. -- *********************************************************************
  391.  
  392.  
  393.  
  394. Clouston & Moore            Standards Track                     [Page 7]
  395.  
  396. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  397.  
  398.  
  399. hprAnrRouting        OBJECT IDENTIFIER ::= { hprObjects 2 }
  400. -- *********************************************************************
  401.  
  402. hprAnrsAssigned OBJECT-TYPE
  403.       SYNTAX Counter32
  404.       UNITS "ANR labels"
  405.       MAX-ACCESS read-only
  406.       STATUS current
  407.       DESCRIPTION
  408.           "The count of ANR labels assigned by this node since it was
  409.           last re-initialized.  A Management Station can detect
  410.           discontinuities in this counter by monitoring the
  411.           appnNodeCounterDisconTime object in the APPN MIB."
  412.  
  413.       ::= { hprAnrRouting 1 }
  414.  
  415. hprAnrCounterState  OBJECT-TYPE
  416.       SYNTAX INTEGER {
  417.                       notActive(1),
  418.                       active(2)
  419.                      }
  420.       MAX-ACCESS read-write
  421.       STATUS current
  422.       DESCRIPTION
  423.           "This object is used for a network management station to turn
  424.           on/off the counting of ANR packets in the hprAnrRoutingTable.
  425.           The initial value of this object is an implementation choice.
  426.  
  427.                  notActive(1) - the counter hprAnrPacketsReceived
  428.                                 returns no meaningful value
  429.                  active(2)    - the counter hprAnrPacketsReceived is
  430.                                 being incremented and is returning
  431.                                 meaningful values"
  432.  
  433.       ::= { hprAnrRouting 2 }
  434.  
  435. hprAnrCounterStateTime OBJECT-TYPE
  436.       SYNTAX DateAndTime
  437.       MAX-ACCESS read-only
  438.       STATUS current
  439.       DESCRIPTION
  440.           "The time when the hprAnrCounterState object last changed its
  441.           value.  The initial value returned by this object is the time
  442.           at which the APPN node instrumented with this MIB was last
  443.           brought up."
  444.  
  445.       ::= { hprAnrRouting 3 }
  446.  
  447.  
  448.  
  449.  
  450. Clouston & Moore            Standards Track                     [Page 8]
  451.  
  452. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  453.  
  454.  
  455. hprAnrRoutingTable OBJECT-TYPE
  456.       SYNTAX SEQUENCE OF HprAnrRoutingEntry
  457.       MAX-ACCESS not-accessible
  458.       STATUS current
  459.       DESCRIPTION
  460.           "The ANR Routing table provides a means of correlating an
  461.           incoming ANR label (i.e., one assigned by this node) with the
  462.           TG over which a packet containing the label will be forwarded.
  463.           When the ANR label identifies a local NCE, the hprAnrOutTgDest
  464.           and hprAnrOutTgNum objects have no meaning.  The table also
  465.           contains an object to count the number of packets received
  466.           with a given ANR label."
  467.  
  468.       ::= { hprAnrRouting 4 }
  469.  
  470. hprAnrRoutingEntry OBJECT-TYPE
  471.       SYNTAX HprAnrRoutingEntry
  472.       MAX-ACCESS not-accessible
  473.       STATUS current
  474.       DESCRIPTION
  475.           "The ANR label is used to index this table."
  476.  
  477.       INDEX  { hprAnrLabel }
  478.  
  479.       ::= { hprAnrRoutingTable 1 }
  480.  
  481. HprAnrRoutingEntry ::= SEQUENCE {
  482.      hprAnrLabel             OCTET STRING,
  483.      hprAnrType              INTEGER,
  484.      hprAnrOutTgDest         DisplayString,
  485.      hprAnrOutTgNum          INTEGER,
  486.      hprAnrPacketsReceived   Counter32,
  487.      hprAnrCounterDisconTime TimeStamp
  488.      }
  489.  
  490. hprAnrLabel OBJECT-TYPE
  491.       SYNTAX OCTET STRING (SIZE (1..8))
  492.       MAX-ACCESS not-accessible
  493.       STATUS current
  494.       DESCRIPTION
  495.           "The first ANR label in an incoming packet."
  496.  
  497.       ::= { hprAnrRoutingEntry 1 }
  498.  
  499. hprAnrType OBJECT-TYPE
  500.       SYNTAX INTEGER {
  501.                       nce(1),
  502.                       tg(2)
  503.  
  504.  
  505.  
  506. Clouston & Moore            Standards Track                     [Page 9]
  507.  
  508. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  509.  
  510.  
  511.                      }
  512.       MAX-ACCESS read-only
  513.       STATUS current
  514.       DESCRIPTION
  515.           "An object indicating whether an ANR label assigned by this
  516.           node identifies a local NCE or a TG on which outgoing packets
  517.           are forwarded.
  518.  
  519.               nce(1)  - the ANR label identifies a local NCE.  In this
  520.                         case the hprAnrOutTgDest and hprAnrOutTgNum
  521.                         objects have no meaning.
  522.               tg(2)   - the ANR label identifies a TG."
  523.  
  524.       ::= { hprAnrRoutingEntry 2 }
  525.  
  526. hprAnrOutTgDest OBJECT-TYPE
  527.       SYNTAX DisplayString (SIZE (0 | 3..17))
  528.       MAX-ACCESS read-only
  529.       STATUS current
  530.       DESCRIPTION
  531.           "Destination node for the TG over which packets with this ANR
  532.           label are forwarded.  This is the fully qualified name of an
  533.           APPN network node or end node, formatted according to the
  534.           SnaControlPointName textual convention.  If the ANR label
  535.           identifies a local NCE, then this object returns a zero-length
  536.           string.
  537.  
  538.           This object corresponds to the appnLocalTgDest object in the
  539.           APPN MIB."
  540.  
  541.       ::= { hprAnrRoutingEntry 3 }
  542.  
  543. hprAnrOutTgNum OBJECT-TYPE
  544.       SYNTAX INTEGER (0..255)
  545.       MAX-ACCESS read-only
  546.       STATUS current
  547.       DESCRIPTION
  548.           "Number of the TG over which packets with this ANR label are
  549.           forwarded.  If the ANR label identifies a local NCE, then this
  550.           object returns the value 0, since 0 is not a valid TG number
  551.           for a TG that supports HPR.
  552.  
  553.           This object corresponds to the appnLocalTgNum object in the
  554.           APPN MIB."
  555.  
  556.       ::= { hprAnrRoutingEntry 4 }
  557.  
  558. hprAnrPacketsReceived OBJECT-TYPE
  559.  
  560.  
  561.  
  562. Clouston & Moore            Standards Track                    [Page 10]
  563.  
  564. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  565.  
  566.  
  567.       SYNTAX Counter32
  568.       UNITS "ANR packets"
  569.       MAX-ACCESS read-only
  570.       STATUS current
  571.       DESCRIPTION
  572.           "The count of packets received with this ANR label as their
  573.           first label.
  574.  
  575.           A Management Station can detect discontinuities in this
  576.           counter by monitoring the hprAnrCounterDisconTime object in
  577.           the same row."
  578.  
  579.       ::= { hprAnrRoutingEntry 5 }
  580.  
  581. hprAnrCounterDisconTime OBJECT-TYPE
  582.       SYNTAX TimeStamp
  583.       MAX-ACCESS read-only
  584.       STATUS current
  585.       DESCRIPTION
  586.           "The value of the sysUpTime object when the
  587.           hprAnrPacketsReceived counter for this ANR label last
  588.           experienced a discontinuity.  This will be the more recent of
  589.           two times:  the time at which the ANR label was associated with
  590.           either an outgoing TG or a local NCE, or the time at which the
  591.           ANR counters were last turned on or off."
  592.  
  593.       ::= { hprAnrRoutingEntry 6 }
  594.  
  595. -- *********************************************************************
  596. hprTransportUser     OBJECT IDENTIFIER ::= { hprObjects 3 }
  597. -- *********************************************************************
  598. -- Transport Service User (TU) Table: (RTP Connection Users)
  599. --
  600. -- There will be several users of the HPR transport and each HPR node
  601. -- shall maintain a table of these users.
  602. -- *********************************************************************
  603.  
  604. hprNceTable OBJECT-TYPE
  605.       SYNTAX SEQUENCE OF HprNceEntry
  606.       MAX-ACCESS not-accessible
  607.       STATUS current
  608.       DESCRIPTION
  609.           "The Network Connection Endpoint (NCE) table."
  610.  
  611.       ::= { hprTransportUser 1 }
  612.  
  613. hprNceEntry OBJECT-TYPE
  614.       SYNTAX HprNceEntry
  615.  
  616.  
  617.  
  618. Clouston & Moore            Standards Track                    [Page 11]
  619.  
  620. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  621.  
  622.  
  623.       MAX-ACCESS not-accessible
  624.       STATUS current
  625.       DESCRIPTION
  626.           "The NCE ID is used to index this table."
  627.  
  628.       INDEX  { hprNceId }
  629.  
  630.       ::= { hprNceTable 1 }
  631.  
  632. HprNceEntry ::= SEQUENCE {
  633.      hprNceId            OCTET STRING,
  634.      hprNceType          HprNceTypes,
  635.      hprNceDefault       HprNceTypes,
  636.      hprNceInstanceId    OCTET STRING
  637.      }
  638.  
  639. hprNceId OBJECT-TYPE
  640.       SYNTAX OCTET STRING (SIZE (1..8))
  641.       MAX-ACCESS not-accessible
  642.       STATUS current
  643.       DESCRIPTION
  644.           "The Network Connection Endpoint (NCE) ID.  NCEs identify
  645.           Control Points (Cp), Logical Units (Lu), HPR Boundary
  646.           Functions (Bf) and Route Setup (Rs) Functions.  A value for
  647.           this object can be retrieved from any of the following
  648.           objects in the APPN MIB:
  649.  
  650.                - appnLsCpCpNceId
  651.                - appnLsRouteNceId
  652.                - appnLsBfNceId
  653.                - appnIsInRtpNceId
  654.                - appnIsRtpNceId
  655.  
  656.           In each case this value identifies a row in this table
  657.           containing information related to that in the APPN MIB."
  658.  
  659.       ::= { hprNceEntry 1 }
  660.  
  661. hprNceType OBJECT-TYPE
  662.       SYNTAX HprNceTypes
  663.       MAX-ACCESS read-only
  664.       STATUS current
  665.       DESCRIPTION
  666.           "A bit string identifying the function types provided by this
  667.           Network Connection Endpoint (NCE)."
  668.  
  669.       ::= { hprNceEntry 2 }
  670.  
  671.  
  672.  
  673.  
  674. Clouston & Moore            Standards Track                    [Page 12]
  675.  
  676. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  677.  
  678.  
  679. hprNceDefault OBJECT-TYPE
  680.       SYNTAX HprNceTypes
  681.       MAX-ACCESS read-only
  682.       STATUS current
  683.       DESCRIPTION
  684.           "A bit string identifying the function types for which this
  685.           Network Connection Endpoint (NCE) is the default NCE.  While
  686.           default NCEs are not explicitly defined in the architecture,
  687.           some implementations provide them; for such implementations,
  688.           it is useful to make this information available to a
  689.           Management Station."
  690.  
  691.       ::= { hprNceEntry 3 }
  692.  
  693. hprNceInstanceId   OBJECT-TYPE
  694.       SYNTAX OCTET STRING (SIZE (4))
  695.       MAX-ACCESS read-only
  696.       STATUS current
  697.       DESCRIPTION
  698.           "The NCE instance identifier (NCEII) identifying the current
  699.           instance of this NCE.  An NCEII is used to denote different
  700.           instances (IPLs) of an NCE component.  Each time an NCE is
  701.           activated (IPL'd), it acquires a different, unique NCEII."
  702.  
  703.       ::= { hprNceEntry 4 }
  704.  
  705. -- *********************************************************************
  706. hprRtp               OBJECT IDENTIFIER ::= { hprObjects 4 }
  707. -- *********************************************************************
  708. -- *********************************************************************
  709. --
  710. -- The RTP group is implemented by all managed nodes supporting the
  711. -- HPR Transport Tower.  The group contains several scalars (simple
  712. -- objects) and a table.
  713. -- *********************************************************************
  714.  
  715. -- *********************************************************************
  716. hprRtpGlobe          OBJECT IDENTIFIER ::= { hprRtp 1}
  717. -- *********************************************************************
  718. hprRtpGlobeConnSetups  OBJECT-TYPE
  719.       SYNTAX Counter32
  720.       UNITS "RTP connection setups"
  721.       MAX-ACCESS read-only
  722.       STATUS current
  723.       DESCRIPTION
  724.           "The count of RTP connection setups in which this node has
  725.           participated, as either sender or receiver, since it was last
  726.           re-initialized.  Retries of a setup attempt do not cause the
  727.  
  728.  
  729.  
  730. Clouston & Moore            Standards Track                    [Page 13]
  731.  
  732. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  733.  
  734.  
  735.           counter to be incremented.
  736.  
  737.           A Management Station can detect discontinuities in this
  738.           counter by monitoring the appnNodeCounterDisconTime object
  739.           in the APPN MIB."
  740.  
  741.       ::= { hprRtpGlobe 1 }
  742.  
  743. hprRtpGlobeCtrState OBJECT-TYPE
  744.       SYNTAX INTEGER {
  745.                       notActive(1),
  746.                       active(2)
  747.                      }
  748.       MAX-ACCESS read-write
  749.       STATUS current
  750.       DESCRIPTION
  751.           "This object allows a network management station to turn the
  752.           counters in the hprRtpTable on and off.  The initial value of
  753.           this object is an implementation choice.
  754.  
  755.                  notActive(1) - the counters in the hprRtpTable are
  756.                                 returning no meaningful values
  757.                  active(2)    - the counters in the hprRtpTable are
  758.                                 being incremented and are returning
  759.                                 meaningful values"
  760.  
  761.       ::= { hprRtpGlobe 2 }
  762.  
  763. hprRtpGlobeCtrStateTime OBJECT-TYPE
  764.       SYNTAX DateAndTime
  765.       MAX-ACCESS read-only
  766.       STATUS current
  767.       DESCRIPTION
  768.           "The time when the value of the hprRtpGlobeCtrState object
  769.           last changed.  The initial value returned by this object is
  770.           the time at which the APPN node instrumented with this MIB
  771.           was last brought up."
  772.  
  773.       ::= { hprRtpGlobe 3 }
  774.  
  775. -- *********************************************************************
  776. -- The RTP Connection Table
  777. -- There may be many RTP connections on a node supporting the functions
  778. -- specified in the RTP option set.  Each node implementing this option
  779. -- set shall maintain a table of these RTP connections.
  780. -- *********************************************************************
  781.  
  782. hprRtpTable OBJECT-TYPE
  783.  
  784.  
  785.  
  786. Clouston & Moore            Standards Track                    [Page 14]
  787.  
  788. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  789.  
  790.  
  791.       SYNTAX SEQUENCE OF HprRtpEntry
  792.       MAX-ACCESS not-accessible
  793.       STATUS current
  794.       DESCRIPTION
  795.           "The RTP Connection table"
  796.  
  797.       ::= { hprRtp 2 }
  798.  
  799. hprRtpEntry OBJECT-TYPE
  800.       SYNTAX HprRtpEntry
  801.       MAX-ACCESS not-accessible
  802.       STATUS current
  803.       DESCRIPTION
  804.           "The local NCE ID and local TCID are used to index this
  805.           table."
  806.  
  807.       INDEX
  808.              { hprRtpLocNceId,
  809.                hprRtpLocTcid }
  810.  
  811.       ::= { hprRtpTable 1 }
  812.  
  813. HprRtpEntry ::= SEQUENCE {
  814.      hprRtpLocNceId          OCTET STRING,       -- local nce id
  815.      hprRtpLocTcid           OCTET STRING,       -- local tcid
  816.      hprRtpRemCpName         SnaControlPointName,-- remote cp name
  817.      hprRtpRemNceId          OCTET STRING,       -- remote nce id
  818.      hprRtpRemTcid           OCTET STRING,       -- remote tcid
  819.      hprRtpPathSwitchTrigger INTEGER,            -- trigger (read-write)
  820.      hprRtpRscv              OCTET STRING,       -- rscv
  821.      hprRtpTopic             DisplayString,      -- topic (cos)
  822.      hprRtpState             INTEGER,            -- state
  823.      hprRtpUpTime            TimeTicks,          -- up time
  824.  
  825.      hprRtpLivenessTimer     Unsigned32,         -- liveness timer
  826.      hprRtpShortReqTimer     Unsigned32,         -- short request timer
  827.      hprRtpPathSwTimer       Unsigned32,         -- path switch timer
  828.      hprRtpLivenessTimeouts  HprRtpCounter,      -- liveness timeouts
  829.      hprRtpShortReqTimeouts  HprRtpCounter,      -- short req timeouts
  830.  
  831.      hprRtpMaxSendRate       Gauge32,            -- maximum send rate
  832.      hprRtpMinSendRate       Gauge32,            -- minimum send rate
  833.      hprRtpCurSendRate       Gauge32,            -- current send rate
  834.  
  835.      hprRtpSmRdTripDelay     Gauge32,            -- smooth rnd trip
  836.                                                     delay
  837.  
  838.      hprRtpSendPackets       HprRtpCounter,      -- packets sent
  839.  
  840.  
  841.  
  842. Clouston & Moore            Standards Track                    [Page 15]
  843.  
  844. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  845.  
  846.  
  847.      hprRtpRecvPackets       HprRtpCounter,      -- packets received
  848.      hprRtpSendBytes         HprRtpCounter,      -- bytes sent
  849.      hprRtpRecvBytes         HprRtpCounter,      -- bytes received
  850.  
  851.      hprRtpRetrPackets       HprRtpCounter,      -- pkts re-xmitted
  852.      hprRtpPacketsDiscarded  HprRtpCounter,      -- pkts discarded
  853.      hprRtpDetectGaps        HprRtpCounter,      -- gaps detected
  854.      hprRtpRateReqSends      HprRtpCounter,      -- rate req send
  855.  
  856.      hprRtpOkErrPathSws      HprRtpCounter,      -- ok  err path sws
  857.      hprRtpBadErrPathSws     HprRtpCounter,      -- bad err path sws
  858.      hprRtpOkOpPathSws       HprRtpCounter,      -- ok  op  path sws
  859.      hprRtpBadOpPathSws      HprRtpCounter,      -- bad op  path sws
  860.  
  861.      hprRtpCounterDisconTime TimeStamp           -- discontinuity ind
  862.         }
  863.  
  864. hprRtpLocNceId OBJECT-TYPE
  865.       SYNTAX OCTET STRING (SIZE (1..8))
  866.       MAX-ACCESS not-accessible
  867.       STATUS current
  868.       DESCRIPTION
  869.           "The local Network Connection Endpoint (NCE) ID of this RTP
  870.           connection.  NCEs identify CPs, LUs, Boundary Functions (BFs),
  871.           and Route Setup (RS) components.  A value for this object can
  872.           be retrieved from any of the following objects in the APPN
  873.           MIB:
  874.  
  875.                - appnLsCpCpNceId
  876.                - appnLsRouteNceId
  877.                - appnLsBfNceId
  878.                - appnIsInRtpNceId
  879.                - appnIsRtpNceId
  880.  
  881.           In each case this value identifies a row in this table
  882.           containing information related to that in the APPN MIB."
  883.  
  884.       ::= { hprRtpEntry 1 }
  885.  
  886. hprRtpLocTcid OBJECT-TYPE
  887.       SYNTAX OCTET STRING (SIZE (8))
  888.       MAX-ACCESS not-accessible
  889.       STATUS current
  890.       DESCRIPTION
  891.           "The local TCID of this RTP connection.  A value for this
  892.           object can be retrieved from either the appnIsInRtpTcid object
  893.           or the appnIsRtpTcid object the APPN MIB; in each case this
  894.           value identifies a row in this table containing information
  895.  
  896.  
  897.  
  898. Clouston & Moore            Standards Track                    [Page 16]
  899.  
  900. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  901.  
  902.  
  903.           related to that in the APPN MIB."
  904.  
  905.       ::= { hprRtpEntry 2 }
  906.  
  907. hprRtpRemCpName OBJECT-TYPE
  908.       SYNTAX SnaControlPointName
  909.       MAX-ACCESS read-only
  910.       STATUS current
  911.       DESCRIPTION
  912.           "Administratively assigned network name for the remote node of
  913.           this RTP connection."
  914.  
  915.       ::= { hprRtpEntry 3 }
  916.  
  917. hprRtpRemNceId OBJECT-TYPE
  918.       SYNTAX OCTET STRING (SIZE (1..8))
  919.       MAX-ACCESS read-only
  920.       STATUS current
  921.       DESCRIPTION
  922.           "The remote Network Connection Endpoint (NCE) of this RTP
  923.           connection.  NCEs identify CPs, LUs, Boundary Functions (BFs),
  924.           and Route Setup (RS) components."
  925.  
  926.       ::= { hprRtpEntry 4 }
  927.  
  928. hprRtpRemTcid OBJECT-TYPE
  929.       SYNTAX OCTET STRING (SIZE (8))
  930.       MAX-ACCESS read-only
  931.       STATUS current
  932.       DESCRIPTION
  933.           "The remote TCID of this RTP connection."
  934.  
  935.       ::= { hprRtpEntry 5 }
  936.  
  937. hprRtpPathSwitchTrigger OBJECT-TYPE
  938.       SYNTAX INTEGER {
  939.                       ready(1),
  940.                       switchPathNow(2)
  941.                      }
  942.       MAX-ACCESS read-write
  943.       STATUS current
  944.       DESCRIPTION
  945.           "Object by which a Management Station can trigger an operator-
  946.           requested path switch, by setting the value to
  947.           switchPathNow(2).  Setting this object to switchPathNow(2)
  948.           triggers a path switch even if its previous value was already
  949.           switchPathNow(2).
  950.  
  951.  
  952.  
  953.  
  954. Clouston & Moore            Standards Track                    [Page 17]
  955.  
  956. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  957.  
  958.  
  959.           The value ready(1) is returned on GET operations until a SET
  960.           has been processed; after that the value received on the most
  961.           recent SET is returned.
  962.  
  963.           This MIB module provides no support for an operator-requested
  964.           switch to a specified path."
  965.  
  966.       ::= { hprRtpEntry 6 }
  967.  
  968. hprRtpRscv OBJECT-TYPE
  969.       SYNTAX OCTET STRING (SIZE (0..255))
  970.       MAX-ACCESS read-only
  971.       STATUS current
  972.       DESCRIPTION
  973.           "The forward Route Selection Control Vector for this RTP
  974.           connection.  The format of this vector is described in SNA
  975.           Formats.
  976.  
  977.           The value returned in this object during a path switch is
  978.           implementation-dependent:  it may be the old path, the new
  979.           path, a zero-length string, or some other valid RSCV string."
  980.  
  981.       ::= { hprRtpEntry 7 }
  982.  
  983. hprRtpTopic OBJECT-TYPE
  984.       SYNTAX DisplayString (SIZE(8))
  985.       MAX-ACCESS read-only
  986.       STATUS current
  987.       DESCRIPTION
  988.           "The topic for this RTP connection.  This is used to indicate
  989.           the Class of Service."
  990.  
  991.       ::= { hprRtpEntry 8 }
  992.  
  993. hprRtpState OBJECT-TYPE
  994.       SYNTAX INTEGER {
  995.                       rtpListening(1),
  996.                       rtpCalling(2),
  997.                       rtpConnected(3),
  998.                       rtpPathSwitching(4),
  999.                       rtpDisconnecting(5),
  1000.                       other(99)
  1001.                      }
  1002.       MAX-ACCESS read-only
  1003.       STATUS current
  1004.       DESCRIPTION
  1005.           "The state of the RTP connection, from the perspective of the
  1006.           local RTP protocol machine:
  1007.  
  1008.  
  1009.  
  1010. Clouston & Moore            Standards Track                    [Page 18]
  1011.  
  1012. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1013.  
  1014.  
  1015.               rtpListening      - connection open; waiting for other end
  1016.                                   to call in
  1017.               rtpCalling        - connection opened, attempting to call
  1018.                                   out, have not yet received any data
  1019.                                   from other end
  1020.               rtpConnected      - connection is active; responded to a
  1021.                                   call-in or received other end's TCID
  1022.                                   from a call-out attempt
  1023.               rtpPathSwitching  - the path switch timer is running;
  1024.                                   attempting to find a new path for this
  1025.                                   connection.
  1026.               rtpDisconnecting  - no sessions are using this connection;
  1027.                                   in process of bringing it down
  1028.               other             - the connection is not in any of the
  1029.                                   states listed above."
  1030.  
  1031.       ::= { hprRtpEntry 9 }
  1032.  
  1033. hprRtpUpTime OBJECT-TYPE
  1034.       SYNTAX TimeTicks
  1035.       UNITS "1/100ths of a second"
  1036.       MAX-ACCESS read-only
  1037.       STATUS current
  1038.       DESCRIPTION
  1039.           "The length of time the RTP connection has been up, measured
  1040.           in 1/100ths of a second."
  1041.  
  1042.       ::= { hprRtpEntry 10 }
  1043.  
  1044. hprRtpLivenessTimer OBJECT-TYPE
  1045.       SYNTAX Unsigned32
  1046.       UNITS "1/100ths of a second"
  1047.       MAX-ACCESS read-only
  1048.       STATUS current
  1049.       DESCRIPTION
  1050.           "The value of the liveness (ALIVE) timer of this RTP
  1051.           connection, in units of 1/100th of a second.  When this timer
  1052.           expires and no packet has arrived from the partner since it
  1053.           was last set, packets with Status Request indicators will be
  1054.           sent to see if the RTP connection is still alive."
  1055.  
  1056.       ::= { hprRtpEntry 11 }
  1057.  
  1058. hprRtpShortReqTimer  OBJECT-TYPE
  1059.       SYNTAX Unsigned32
  1060.       UNITS "1/100ths of a second"
  1061.       MAX-ACCESS read-only
  1062.       STATUS current
  1063.  
  1064.  
  1065.  
  1066. Clouston & Moore            Standards Track                    [Page 19]
  1067.  
  1068. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1069.  
  1070.  
  1071.       DESCRIPTION
  1072.           "The value of the RTP SHORT_REQ timer, in units of 1/100 of a
  1073.           second.  This timer represents the maximum time that a sender
  1074.           waits for a reply from a receiver."
  1075.  
  1076.       ::= { hprRtpEntry 12 }
  1077.  
  1078. hprRtpPathSwTimer OBJECT-TYPE
  1079.       SYNTAX Unsigned32
  1080.       UNITS "1/100ths of a second"
  1081.       MAX-ACCESS read-only
  1082.       STATUS current
  1083.       DESCRIPTION
  1084.           "The length of time that RTP should attempt a path switch
  1085.           for a connection, in units of 1/100th of a second."
  1086.  
  1087.       ::= { hprRtpEntry 13 }
  1088.  
  1089. hprRtpLivenessTimeouts OBJECT-TYPE
  1090.       SYNTAX HprRtpCounter
  1091.       UNITS "liveness timeouts"
  1092.       MAX-ACCESS read-only
  1093.       STATUS current
  1094.       DESCRIPTION
  1095.           "The count of liveness timeouts for this RTP connection."
  1096.  
  1097.       ::= { hprRtpEntry 14 }
  1098.  
  1099. hprRtpShortReqTimeouts OBJECT-TYPE
  1100.       SYNTAX HprRtpCounter
  1101.       UNITS "short request timeouts"
  1102.       MAX-ACCESS read-only
  1103.       STATUS current
  1104.       DESCRIPTION
  1105.           "The count of short request timeouts for this RTP connection."
  1106.  
  1107.       ::= { hprRtpEntry 15 }
  1108.  
  1109. hprRtpMaxSendRate OBJECT-TYPE
  1110.       SYNTAX Gauge32
  1111.       UNITS "bytes per second"
  1112.       MAX-ACCESS read-only
  1113.       STATUS current
  1114.       DESCRIPTION
  1115.           "The high-water mark for this RTP connection's send rate, in
  1116.           units of bytes per second.  This is the high-water mark for
  1117.           the entire life of the connection, not just the high-water
  1118.           mark for the connection's current path.
  1119.  
  1120.  
  1121.  
  1122. Clouston & Moore            Standards Track                    [Page 20]
  1123.  
  1124. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1125.  
  1126.  
  1127.           For more details on this and other parameters related to HPR,
  1128.           see the High Performance Routing Architecture Reference."
  1129.  
  1130.       ::= { hprRtpEntry 16 }
  1131.  
  1132. hprRtpMinSendRate OBJECT-TYPE
  1133.       SYNTAX Gauge32
  1134.       UNITS "bytes per second"
  1135.       MAX-ACCESS read-only
  1136.       STATUS current
  1137.       DESCRIPTION
  1138.           "The low-water mark for this RTP connection's send rate, in
  1139.           units of bytes per second.  This is the low-water mark for the
  1140.           entire life of the connection, not just the low-water mark for
  1141.           the connection's current path.
  1142.  
  1143.           For more details on this and other parameters related to HPR,
  1144.           see the High Performance Routing Architecture Reference."
  1145.  
  1146.       ::= { hprRtpEntry 17 }
  1147.  
  1148. hprRtpCurSendRate OBJECT-TYPE
  1149.       SYNTAX Gauge32
  1150.       UNITS "bytes per second"
  1151.       MAX-ACCESS read-only
  1152.       STATUS current
  1153.       DESCRIPTION
  1154.           "The current send rate for this RTP connection, in units of
  1155.           bytes per second.
  1156.  
  1157.           For more details on this and other parameters related to HPR,
  1158.           see the High Performance Routing Architecture Reference."
  1159.  
  1160.       ::= { hprRtpEntry 18 }
  1161.  
  1162. hprRtpSmRdTripDelay OBJECT-TYPE
  1163.       SYNTAX Gauge32
  1164.       UNITS "1/1000ths of a second"
  1165.       MAX-ACCESS read-only
  1166.       STATUS current
  1167.       DESCRIPTION
  1168.           "The smoothed round trip delay for this RTP connection, in
  1169.           units of 1/1000th of a second (ms).
  1170.  
  1171.           For more details on this and other parameters related to HPR,
  1172.           see the High Performance Routing Architecture Reference."
  1173.  
  1174.       ::= { hprRtpEntry 19 }
  1175.  
  1176.  
  1177.  
  1178. Clouston & Moore            Standards Track                    [Page 21]
  1179.  
  1180. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1181.  
  1182.  
  1183. hprRtpSendPackets OBJECT-TYPE
  1184.       SYNTAX HprRtpCounter
  1185.       UNITS "RTP packets"
  1186.       MAX-ACCESS read-only
  1187.       STATUS current
  1188.       DESCRIPTION
  1189.           "The count of packets successfully sent on this RTP
  1190.           connection."
  1191.  
  1192.       ::= { hprRtpEntry 20 }
  1193.  
  1194. hprRtpRecvPackets OBJECT-TYPE
  1195.       SYNTAX HprRtpCounter
  1196.       UNITS "RTP packets"
  1197.       MAX-ACCESS read-only
  1198.       STATUS current
  1199.       DESCRIPTION
  1200.           "The count of packets received on this RTP connection.  The
  1201.           counter is incremented only once if duplicate copies of a
  1202.           packet are received."
  1203.  
  1204.       ::= { hprRtpEntry 21 }
  1205.  
  1206. hprRtpSendBytes OBJECT-TYPE
  1207.       SYNTAX HprRtpCounter
  1208.       UNITS "bytes"
  1209.       MAX-ACCESS read-only
  1210.       STATUS current
  1211.       DESCRIPTION
  1212.           "The count of bytes sent on this RTP connection.  Both RTP
  1213.           Transport Header (THDR) bytes and data bytes are included in
  1214.           this count."
  1215.  
  1216.       ::= { hprRtpEntry 22 }
  1217.  
  1218. hprRtpRecvBytes OBJECT-TYPE
  1219.       SYNTAX HprRtpCounter
  1220.       UNITS "bytes"
  1221.       MAX-ACCESS read-only
  1222.       STATUS current
  1223.       DESCRIPTION
  1224.           "The count of bytes received on this RTP connection.  Both RTP
  1225.           Transport Header (THDR) bytes and data bytes are included in
  1226.           this count."
  1227.  
  1228.       ::= { hprRtpEntry 23 }
  1229.  
  1230. hprRtpRetrPackets OBJECT-TYPE
  1231.  
  1232.  
  1233.  
  1234. Clouston & Moore            Standards Track                    [Page 22]
  1235.  
  1236. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1237.  
  1238.  
  1239.       SYNTAX HprRtpCounter
  1240.       UNITS "RTP packets"
  1241.       MAX-ACCESS read-only
  1242.       STATUS current
  1243.       DESCRIPTION
  1244.           "The count of packets retransmitted on this RTP connection."
  1245.  
  1246.       ::= { hprRtpEntry 24 }
  1247.  
  1248. hprRtpPacketsDiscarded OBJECT-TYPE
  1249.       SYNTAX HprRtpCounter
  1250.       UNITS "RTP packets"
  1251.       MAX-ACCESS read-only
  1252.       STATUS current
  1253.       DESCRIPTION
  1254.           "The count of packets received on this RTP connection and then
  1255.           discarded.  A packet may be discarded because it is determined
  1256.           to be a duplicate, or for other reasons."
  1257.  
  1258.       ::= { hprRtpEntry 25 }
  1259.  
  1260. hprRtpDetectGaps OBJECT-TYPE
  1261.       SYNTAX HprRtpCounter
  1262.       UNITS "gaps"
  1263.       MAX-ACCESS read-only
  1264.       STATUS current
  1265.       DESCRIPTION
  1266.           "The count of gaps detected on this RTP connection."
  1267.  
  1268.       ::= { hprRtpEntry 26 }
  1269.  
  1270. hprRtpRateReqSends OBJECT-TYPE
  1271.       SYNTAX HprRtpCounter
  1272.       UNITS "rate requests"
  1273.       MAX-ACCESS read-only
  1274.       STATUS current
  1275.       DESCRIPTION
  1276.           "The count of Rate Requests sent on this RTP connection."
  1277.  
  1278.       ::= { hprRtpEntry 27 }
  1279.  
  1280. hprRtpOkErrPathSws OBJECT-TYPE
  1281.       SYNTAX HprRtpCounter
  1282.       UNITS "path switch attempts"
  1283.       MAX-ACCESS read-only
  1284.       STATUS current
  1285.       DESCRIPTION
  1286.           "The count of successful path switch attempts for this RTP
  1287.  
  1288.  
  1289.  
  1290. Clouston & Moore            Standards Track                    [Page 23]
  1291.  
  1292. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1293.  
  1294.  
  1295.           connection due to errors."
  1296.  
  1297.       ::= { hprRtpEntry 28 }
  1298.  
  1299. hprRtpBadErrPathSws OBJECT-TYPE
  1300.       SYNTAX HprRtpCounter
  1301.       UNITS "path switch attempts"
  1302.       MAX-ACCESS read-only
  1303.       STATUS current
  1304.       DESCRIPTION
  1305.           "The count of unsuccessful path switches for this RTP
  1306.           connection due to errors."
  1307.  
  1308.       ::= { hprRtpEntry 29 }
  1309.  
  1310. hprRtpOkOpPathSws OBJECT-TYPE
  1311.       SYNTAX HprRtpCounter
  1312.       UNITS "path switches"
  1313.       MAX-ACCESS read-only
  1314.       STATUS current
  1315.       DESCRIPTION
  1316.           "The count of successful path switches for this RTP connection
  1317.           due to operator requests."
  1318.  
  1319.       ::= { hprRtpEntry 30 }
  1320.  
  1321. hprRtpBadOpPathSws OBJECT-TYPE
  1322.       SYNTAX HprRtpCounter
  1323.       UNITS "path switches"
  1324.       MAX-ACCESS read-only
  1325.       STATUS current
  1326.       DESCRIPTION
  1327.           "The count of unsuccessful path switches for this RTP
  1328.           connection due to operator requests.  This counter is not
  1329.           incremented by an implementation that does not support
  1330.           operator-requested path switches, even if a Management Station
  1331.           requests such a path switch by setting the
  1332.           hprRtpPathSwitchTrigger object."
  1333.  
  1334.       ::= { hprRtpEntry 31 }
  1335.  
  1336. hprRtpCounterDisconTime OBJECT-TYPE
  1337.       SYNTAX TimeStamp
  1338.       MAX-ACCESS read-only
  1339.       STATUS current
  1340.       DESCRIPTION
  1341.           "The value of the sysUpTime object when the counters for this
  1342.           RTP connection last experienced a discontinuity.  This will be
  1343.  
  1344.  
  1345.  
  1346. Clouston & Moore            Standards Track                    [Page 24]
  1347.  
  1348. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1349.  
  1350.  
  1351.           the more recent of two times:  the time at which the
  1352.           connection was established or the time at which the HPR
  1353.           counters were last turned on or off."
  1354.  
  1355.       ::= { hprRtpEntry 32 }
  1356.  
  1357. -- *********************************************************************
  1358. -- The RTP Connection Status Table
  1359. --  This table contains statistics and historical information related to
  1360. --  both successful and unsuccessful RTP path switches.  This
  1361. --  information can be important for both trend analysis and problem
  1362. --  determination.
  1363. --
  1364. --  Note the terminology here:  when RTP is triggered to find a new path
  1365. --  for a connection, this initiates a 'path switch,' which will end up
  1366. --  being either successful or unsuccessful.  During this path switch,
  1367. --  RTP will make one or more 'path switch attempts,' which are attempts
  1368. --  to find a new path for the connection and switch the connection to
  1369. --  it.  This 'new' path may be the same path that the connection was
  1370. --  using before the path switch.
  1371. --
  1372. --  It is an implementation option how many entries to keep in this
  1373. --  table, and how long to retain any individual entry.
  1374. -- *********************************************************************
  1375. hprRtpStatusTable OBJECT-TYPE
  1376.       SYNTAX SEQUENCE OF HprRtpStatusEntry
  1377.       MAX-ACCESS not-accessible
  1378.       STATUS current
  1379.       DESCRIPTION
  1380.           "RTP Connection Status Table:  This table contains historical
  1381.           information on RTP connections.  An entry is created in this
  1382.           table when a path switch is completed, either successfully or
  1383.           unsuccessfully."
  1384.  
  1385.       ::= { hprRtp 3 }
  1386.  
  1387. hprRtpStatusEntry OBJECT-TYPE
  1388.       SYNTAX HprRtpStatusEntry
  1389.       MAX-ACCESS not-accessible
  1390.       STATUS current
  1391.       DESCRIPTION
  1392.           "This table is indexed by local NCE ID, local TCID, and an
  1393.           integer hprRtpStatusIndex.  Thus the primary grouping of table
  1394.           rows is by RTP connection, with the multiple entries for a
  1395.           given RTP connection ordered by time."
  1396.  
  1397.       INDEX
  1398.              { hprRtpStatusLocNceId,
  1399.  
  1400.  
  1401.  
  1402. Clouston & Moore            Standards Track                    [Page 25]
  1403.  
  1404. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1405.  
  1406.  
  1407.                hprRtpStatusLocTcid,
  1408.                hprRtpStatusIndex }
  1409.  
  1410.       ::= { hprRtpStatusTable 1 }
  1411.  
  1412.   HprRtpStatusEntry ::= SEQUENCE {
  1413.      hprRtpStatusLocNceId          OCTET STRING, -- local nce id
  1414.      hprRtpStatusLocTcid           OCTET STRING, -- local tcid
  1415.      hprRtpStatusIndex             Unsigned32,   -- index
  1416.      hprRtpStatusStartTime         DateAndTime,  -- time stamp
  1417.      hprRtpStatusEndTime           DateAndTime,  -- time stamp
  1418.      hprRtpStatusRemCpName         SnaControlPointName,-- remote cp name
  1419.      hprRtpStatusRemNceId          OCTET STRING, -- remote nce id
  1420.      hprRtpStatusRemTcid           OCTET STRING, -- remote tcid
  1421.      hprRtpStatusNewRscv           OCTET STRING, -- new rscv
  1422.      hprRtpStatusOldRscv           OCTET STRING, -- old rscv
  1423.      hprRtpStatusCause             INTEGER,      -- cause
  1424.      hprRtpStatusLastAttemptResult INTEGER       -- result of last
  1425.                                           }
  1426.  
  1427. hprRtpStatusLocNceId OBJECT-TYPE
  1428.       SYNTAX OCTET STRING (SIZE (1..8))
  1429.       MAX-ACCESS not-accessible
  1430.       STATUS current
  1431.       DESCRIPTION
  1432.           "The local Network Connection Endpoint (NCE) of this RTP
  1433.           connection.  NCEs identify CPs, LUs, Boundary Functions (BFs),
  1434.           and Route Setup (RS) components."
  1435.  
  1436.       ::= { hprRtpStatusEntry 1 }
  1437.  
  1438. hprRtpStatusLocTcid OBJECT-TYPE
  1439.       SYNTAX OCTET STRING (SIZE (8))
  1440.       MAX-ACCESS not-accessible
  1441.       STATUS current
  1442.       DESCRIPTION
  1443.           "The local TCID of this RTP connection."
  1444.  
  1445.       ::= { hprRtpStatusEntry 2 }
  1446.  
  1447. hprRtpStatusIndex OBJECT-TYPE
  1448.       SYNTAX Unsigned32 (1..4294967295)
  1449.       MAX-ACCESS not-accessible
  1450.       STATUS current
  1451.       DESCRIPTION
  1452.           "Table index.  This value begins at one and is incremented
  1453.           when a new entry is added to the table.  It is an
  1454.           implementation choice whether to run a single counter for
  1455.  
  1456.  
  1457.  
  1458. Clouston & Moore            Standards Track                    [Page 26]
  1459.  
  1460. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1461.  
  1462.  
  1463.           all entries in the table, or to run a separate counter for
  1464.           the entries for each RTP connection.  In the unlikely event
  1465.           of a wrap, it is assumed that Management Stations will have
  1466.           the ability to order table entries correctly."
  1467.  
  1468.       ::= { hprRtpStatusEntry 3 }
  1469.  
  1470. hprRtpStatusStartTime OBJECT-TYPE
  1471.       SYNTAX DateAndTime
  1472.       MAX-ACCESS read-only
  1473.       STATUS current
  1474.       DESCRIPTION
  1475.           "The time when the path switch began."
  1476.  
  1477.       ::= { hprRtpStatusEntry 4 }
  1478.  
  1479. hprRtpStatusEndTime OBJECT-TYPE
  1480.       SYNTAX DateAndTime
  1481.       MAX-ACCESS read-only
  1482.       STATUS current
  1483.       DESCRIPTION
  1484.           "The time when the path switch was ended, either successfully
  1485.           or unsuccessfully."
  1486.  
  1487.       ::= { hprRtpStatusEntry 5 }
  1488.  
  1489. hprRtpStatusRemCpName OBJECT-TYPE
  1490.       SYNTAX SnaControlPointName
  1491.       MAX-ACCESS read-only
  1492.       STATUS current
  1493.       DESCRIPTION
  1494.           "Administratively assigned network name for the remote node of
  1495.           this RTP connection."
  1496.  
  1497.       ::= { hprRtpStatusEntry 6 }
  1498.  
  1499. hprRtpStatusRemNceId OBJECT-TYPE
  1500.       SYNTAX OCTET STRING (SIZE (1..8))
  1501.       MAX-ACCESS read-only
  1502.       STATUS current
  1503.       DESCRIPTION
  1504.           "The remote Network Connection Endpoint (NCE) of this RTP
  1505.           connection.  NCEs identify CPs, LUs, Boundary Functions (BFs),
  1506.           and Route Setup (RS) components."
  1507.  
  1508.       ::= { hprRtpStatusEntry 7 }
  1509.  
  1510. hprRtpStatusRemTcid OBJECT-TYPE
  1511.  
  1512.  
  1513.  
  1514. Clouston & Moore            Standards Track                    [Page 27]
  1515.  
  1516. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1517.  
  1518.  
  1519.       SYNTAX OCTET STRING (SIZE (8))
  1520.       MAX-ACCESS read-only
  1521.       STATUS current
  1522.       DESCRIPTION
  1523.           "The remote TCID of this RTP connection."
  1524.  
  1525.       ::= { hprRtpStatusEntry 8 }
  1526.  
  1527. hprRtpStatusNewRscv OBJECT-TYPE
  1528.       SYNTAX OCTET STRING (SIZE (0..255))
  1529.       MAX-ACCESS read-only
  1530.       STATUS current
  1531.       DESCRIPTION
  1532.           "The new Route Selection Control Vector for this RTP
  1533.           connection.  A zero-length string indicates that no value is
  1534.           available, perhaps because the implementation does not save
  1535.           RSCVs."
  1536.  
  1537.       ::= { hprRtpStatusEntry 9 }
  1538.  
  1539. hprRtpStatusOldRscv OBJECT-TYPE
  1540.       SYNTAX OCTET STRING (SIZE (0..255))
  1541.       MAX-ACCESS read-only
  1542.       STATUS current
  1543.       DESCRIPTION
  1544.           "The old Route Selection Control Vector for this RTP
  1545.           connection.  A zero-length string indicates that no value is
  1546.           available, perhaps because the implementation does not save
  1547.           RSCVs."
  1548.  
  1549.       ::= { hprRtpStatusEntry 10 }
  1550.  
  1551. hprRtpStatusCause OBJECT-TYPE
  1552.       SYNTAX INTEGER {
  1553.                       other(1),
  1554.                       rtpConnFail(2),
  1555.                       locLinkFail(3),
  1556.                       remLinkFail(4),
  1557.                       operRequest(5)
  1558.                      }
  1559.       MAX-ACCESS read-only
  1560.       STATUS current
  1561.       DESCRIPTION
  1562.           "The reason for the path switch:
  1563.  
  1564.                other(1)       - Reason other than those listed below,
  1565.                rtpConnFail(2) - RTP connection failure detected,
  1566.                locLinkFail(3) - Local link failure,
  1567.  
  1568.  
  1569.  
  1570. Clouston & Moore            Standards Track                    [Page 28]
  1571.  
  1572. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1573.  
  1574.  
  1575.                remLinkFail(4) - Remote link failure (learned from TDUs),
  1576.                operRequest(5) - Operator requested path switch. "
  1577.  
  1578.       ::= { hprRtpStatusEntry 11 }
  1579.  
  1580. hprRtpStatusLastAttemptResult  OBJECT-TYPE
  1581.       SYNTAX INTEGER { successful(1),
  1582.                        initiatorMoving(2),
  1583.                        directorySearchFailed(3),
  1584.                        rscvCalculationFailed(4),
  1585.                        negativeRouteSetupReply(5),
  1586.                        backoutRouteSetupReply(6),
  1587.                        timeoutDuringFirstAttempt(7),
  1588.                        otherUnsuccessful(8)
  1589.                      }
  1590.       MAX-ACCESS read-only
  1591.       STATUS current
  1592.       DESCRIPTION
  1593.           "The result of the last completed path switch attempt.  If the
  1594.           path switch is aborted in the middle of a path switch attempt
  1595.           because the path switch timer expires, the result of the
  1596.           previous path switch attempt is reported.
  1597.  
  1598.           The values are defined as follows:
  1599.  
  1600.              successful(1)                - The final path switch
  1601.                                             attempt was successful.
  1602.              initiatorMoving(2)           - The final path switch
  1603.                                             attempt failed because the
  1604.                                             initiator is mobile, and
  1605.                                             there was no active link
  1606.                                             out of this node.
  1607.              directorySearchFailed(3)     - The final path switch
  1608.                                             attempt failed because a
  1609.                                             directory search for the
  1610.                                             destination node's CP name
  1611.                                             failed.
  1612.              rscvCalculationFailed(4)     - The final path switch
  1613.                                             attempt failed because an
  1614.                                             RSCV to the node containing
  1615.                                             the remote RTP endpoint
  1616.                                             could not be calculated.
  1617.              negativeRouteSetupReply(5)   - The final path switch
  1618.                                             attempt failed because route
  1619.                                             setup failed for the new
  1620.                                             path.
  1621.              backoutRouteSetupReply(6)    - The final path switch
  1622.                                             attempt failed because the
  1623.  
  1624.  
  1625.  
  1626. Clouston & Moore            Standards Track                    [Page 29]
  1627.  
  1628. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1629.  
  1630.  
  1631.                                             remote RTP endpoint refused
  1632.                                             to continue the RTP
  1633.                                             connection.
  1634.              timeoutDuringFirstAttempt(7) - The path switch timer
  1635.                                             expired during the first
  1636.                                             path switch attempt.
  1637.              otherUnsuccessful(8)         - The final path switch
  1638.                                             attempt failed for a reason
  1639.                                             other than those listed
  1640.                                             above."
  1641.  
  1642.  
  1643.       ::= { hprRtpStatusEntry 12 }
  1644.  
  1645.  
  1646. -- ***************************************************************
  1647. -- Conformance information
  1648. -- ***************************************************************
  1649.  
  1650. hprConformance       OBJECT IDENTIFIER ::= { hprMIB 2 }
  1651.  
  1652. hprCompliances       OBJECT IDENTIFIER ::= { hprConformance 1 }
  1653. hprGroups            OBJECT IDENTIFIER ::= { hprConformance 2 }
  1654.  
  1655. -- Compliance statements
  1656.  
  1657. hprCompliance  MODULE-COMPLIANCE
  1658.       STATUS  current
  1659.       DESCRIPTION
  1660.           "The compliance statement for the SNMPv2 entities that
  1661.           implement the HPR MIB."
  1662.  
  1663.       MODULE  -- this module
  1664.  
  1665. --    Unconditionally mandatory groups
  1666.           MANDATORY-GROUPS  {
  1667.                              hprGlobalConfGroup,
  1668.                              hprAnrRoutingConfGroup,
  1669.                              hprTransportUserConfGroup
  1670.                             }
  1671.  
  1672. --    Conditionally mandatory groups
  1673.           GROUP   hprRtpConfGroup
  1674.           DESCRIPTION
  1675.               "The hprRtpConfGroup is mandatory for HPR implementations
  1676.               supporting the HPR transport tower."
  1677.  
  1678.       ::= { hprCompliances 1 }
  1679.  
  1680.  
  1681.  
  1682. Clouston & Moore            Standards Track                    [Page 30]
  1683.  
  1684. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1685.  
  1686.  
  1687. -- Units of conformance
  1688. hprGlobalConfGroup OBJECT-GROUP
  1689.         OBJECTS {
  1690.                  hprNodeCpName,
  1691.                  hprOperatorPathSwitchSupport
  1692.                 }
  1693.       STATUS  current
  1694.       DESCRIPTION
  1695.           "A collection of objects providing the instrumentation of HPR
  1696.           general information and capabilities."
  1697.  
  1698.       ::= { hprGroups 1 }
  1699.  
  1700. hprAnrRoutingConfGroup OBJECT-GROUP
  1701.         OBJECTS {
  1702.                  hprAnrsAssigned,
  1703.                  hprAnrCounterState,
  1704.                  hprAnrCounterStateTime,
  1705.                  hprAnrType,
  1706.                  hprAnrOutTgDest,
  1707.                  hprAnrOutTgNum,
  1708.                  hprAnrPacketsReceived,
  1709.                  hprAnrCounterDisconTime
  1710.                 }
  1711.       STATUS  current
  1712.       DESCRIPTION
  1713.           "A collection of objects providing instrumentation for the
  1714.           node's ANR routing."
  1715.  
  1716.       ::= { hprGroups 2 }
  1717.  
  1718. hprTransportUserConfGroup OBJECT-GROUP
  1719.         OBJECTS {
  1720.                  hprNceType,
  1721.                  hprNceDefault,
  1722.                  hprNceInstanceId
  1723.                 }
  1724.       STATUS  current
  1725.       DESCRIPTION
  1726.           "A collection of objects providing information on the users of
  1727.           the HPR transport known to the node."
  1728.  
  1729.       ::= { hprGroups 3 }
  1730.  
  1731. hprRtpConfGroup  OBJECT-GROUP
  1732.         OBJECTS {
  1733.                  hprRtpGlobeConnSetups,
  1734.                  hprRtpGlobeCtrState,
  1735.  
  1736.  
  1737.  
  1738. Clouston & Moore            Standards Track                    [Page 31]
  1739.  
  1740. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1741.  
  1742.  
  1743.                  hprRtpGlobeCtrStateTime,
  1744.                  hprRtpRemCpName,
  1745.                  hprRtpRemNceId,
  1746.                  hprRtpRemTcid,
  1747.                  hprRtpPathSwitchTrigger,
  1748.                  hprRtpRscv,
  1749.                  hprRtpTopic,
  1750.                  hprRtpState,
  1751.                  hprRtpUpTime,
  1752.                  hprRtpLivenessTimer,
  1753.                  hprRtpShortReqTimer,
  1754.                  hprRtpPathSwTimer,
  1755.                  hprRtpLivenessTimeouts,
  1756.                  hprRtpShortReqTimeouts,
  1757.  
  1758.                  hprRtpMaxSendRate,
  1759.                  hprRtpMinSendRate,
  1760.                  hprRtpCurSendRate,
  1761.  
  1762.                  hprRtpSmRdTripDelay,
  1763.  
  1764.                  hprRtpSendPackets,
  1765.                  hprRtpRecvPackets,
  1766.                  hprRtpSendBytes,
  1767.                  hprRtpRecvBytes,
  1768.  
  1769.                  hprRtpRetrPackets,
  1770.                  hprRtpPacketsDiscarded,
  1771.                  hprRtpDetectGaps,
  1772.                  hprRtpRateReqSends,
  1773.  
  1774.                  hprRtpOkErrPathSws,
  1775.                  hprRtpBadErrPathSws,
  1776.                  hprRtpOkOpPathSws,
  1777.                  hprRtpBadOpPathSws,
  1778.                  hprRtpCounterDisconTime,
  1779.  
  1780.                  hprRtpStatusStartTime,
  1781.                  hprRtpStatusEndTime,
  1782.                  hprRtpStatusRemNceId,
  1783.                  hprRtpStatusRemTcid,
  1784.                  hprRtpStatusRemCpName,
  1785.                  hprRtpStatusNewRscv,
  1786.                  hprRtpStatusOldRscv,
  1787.                  hprRtpStatusCause,
  1788.                  hprRtpStatusLastAttemptResult
  1789.  
  1790.                 }
  1791.  
  1792.  
  1793.  
  1794. Clouston & Moore            Standards Track                    [Page 32]
  1795.  
  1796. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1797.  
  1798.  
  1799.       STATUS  current
  1800.       DESCRIPTION
  1801.           "A collection of objects providing the instrumentation for RTP
  1802.           connection end points."
  1803.  
  1804.       ::= { hprGroups 4 }
  1805.  
  1806. -- end of conformance statement
  1807.  
  1808. END
  1809.  
  1810. 6.  Acknowledgments
  1811.  
  1812.    This MIB module is the product of the IETF SNA NAU MIB WG and the AIW
  1813.    APPN/HPR MIBs SIG.  Thanks to Ray Bird, IBM Corporation; Jim Cobban,
  1814.    Nortel; and Laura Petrie, IBM Corporation, for their contributions
  1815.    and review.
  1816.  
  1817. 7.  References
  1818.  
  1819.    [1]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1820.         "Structure of Management Information for version 2 of
  1821.         the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1822.         January 1996.
  1823.  
  1824.    [2]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1825.         "Textual Conventions for Version 2 of the Simple
  1826.         Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
  1827.  
  1828.    [3]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1829.         "Conformance Statements for Version 2 of the Simple
  1830.         Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
  1831.  
  1832.    [4]  Clouston, B., and B. Moore, "Definition of Managed Objects for
  1833.         APPN", RFC 2115, June 1997.
  1834.  
  1835.    [5]  IBM, APPN High Performance Routing Architecture Reference, SV40-
  1836.         1018-00.
  1837.  
  1838.    [6]  IBM, SNA/MS Formats, GC31-8302-00
  1839.  
  1840. 8.  Security Considerations
  1841.  
  1842.    In most cases, MIBs are not themselves security risks; if SNMP
  1843.    security is operating as intended, the use of a MIB to view
  1844.    information about a system, or to change some parameter at the
  1845.    system, is a tool, not a threat.
  1846.  
  1847.  
  1848.  
  1849.  
  1850. Clouston & Moore            Standards Track                    [Page 33]
  1851.  
  1852. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1853.  
  1854.  
  1855.    None of the read-only objects in the HPR MIB reports a password, user
  1856.    data, or anything else that is particularly sensitive.  Some
  1857.    enterprises view their network configuration itself, as well as
  1858.    information about network usage and performance, as corporate assets;
  1859.    such enterprises may wish to restrict SNMP access to most of the
  1860.    objects in the MIB.
  1861.  
  1862.    One read-write object in the MIB can affect network operations:
  1863.  
  1864.    o    hprRtpPathSwitchTrigger:  Setting this object to 'switchPathNow'
  1865.         triggers an immediate path switch attempt.  An HPR path switch
  1866.         does not itself disrupt the SNA sessions using the RTP
  1867.         connection undergoing the path switch.  However, frequent path
  1868.         switches for many RTP connections can have an adverse impact on
  1869.         overall network performance.
  1870.  
  1871.         It is recommended that SNMP access to this object be restricted.
  1872.  
  1873.         Other read-write objects control the gathering of network
  1874.         management data; controlling access to these objects is less
  1875.         critical.
  1876.  
  1877. 9.  Authors' Addresses
  1878.  
  1879.    Bob Clouston
  1880.    Cisco Systems
  1881.    7025 Kit Creek Road
  1882.    P.O. Box 14987
  1883.    Research Triangle Park, NC 27709, USA
  1884.  
  1885.    Phone: +1 919 472 2333
  1886.    EMail: clouston@cisco.com
  1887.  
  1888.  
  1889.    Bob Moore
  1890.    IBM Corporation
  1891.    800 Park Offices Drive
  1892.    CNMA/664
  1893.    P.O. Box 12195
  1894.    Research Triangle Park, NC 27709, USA
  1895.  
  1896.    Phone: +1 919 254 4436
  1897.    EMail: remoore@ralvm6.vnet.ibm.com
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906. Clouston & Moore            Standards Track                    [Page 34]
  1907.  
  1908. RFC 2238         Definitions of Managed Objects for HPR    November 1997
  1909.  
  1910.  
  1911. 10.  Full Copyright Statement
  1912.  
  1913.    Copyright (C) The Internet Society (1997).  All Rights Reserved.
  1914.  
  1915.    This document and translations of it may be copied and furnished to
  1916.    others, and derivative works that comment on or otherwise explain it
  1917.    or assist in its implementation may be prepared, copied, published
  1918.    and distributed, in whole or in part, without restriction of any
  1919.    kind, provided that the above copyright notice and this paragraph are
  1920.    included on all such copies and derivative works.  However, this
  1921.    document itself may not be modified in any way, such as by removing
  1922.    the copyright notice or references to the Internet Society or other
  1923.    Internet organizations, except as needed for the purpose of
  1924.    developing Internet standards in which case the procedures for
  1925.    copyrights defined in the Internet Standards process must be
  1926.    followed, or as required to translate it into languages other than
  1927.    English.
  1928.  
  1929.    The limited permissions granted above are perpetual and will not be
  1930.    revoked by the Internet Society or its successors or assigns.
  1931.  
  1932.    This document and the information contained herein is provided on an
  1933.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  1934.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  1935.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  1936.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  1937.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962. Clouston & Moore            Standards Track                    [Page 35]
  1963.  
  1964.